<!--

    Copyright (c) 2005, 2018 Oracle and/or its affiliates. All rights reserved.
    Portions Copyright &#169; [2017-2020] Payara Foundation and/or affiliates.

    This program and the accompanying materials are made available under the
    terms of the Eclipse Public License v. 2.0, which is available at
    http://www.eclipse.org/legal/epl-2.0.

    This Source Code may also be made available under the following Secondary
    Licenses when the conditions for such availability set forth in the
    Eclipse Public License v. 2.0 are satisfied: GNU General Public License,
    version 2 with the GNU Classpath Exception, which is available at
    https://www.gnu.org/software/classpath/license.html.

    SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0

-->
<!-- Portions Copyright [2019] [Payara Foundation and/or its affiliates] -->

<p><a id="ref-networklisteneredit" name="ref-networklisteneredit"></a><a id="GHWEB00017" name="GHWEB00017"></a></p>

<h4><a id="sthref136" name="sthref136"></a>Edit Network Listener</h4>
<a name="BEGIN" id="BEGIN"></a>
<p>Use the Edit Network Listener page to modify an existing network listener.</p>
<p>When you edit a network listener, the SSL, HTTP, and File Cache tabs for the associated protocol are available for you to edit as well.</p>
<p>The Edit Network Listener page contains the following options.</p>
<dl>
<dt>Load Defaults</dt>
<dd>
<p>Button to restore settings that have default values to their default values. Settings that do not have default values are not changed.</p>
</dd>
<dt>Configuration Name</dt>
<dd>
<p>The name of the configuration to which the settings on this page apply. This field is read only.</p>
</dd>
<dt>Name</dt>
<dd>
<p>The unique listener name. The Name field is a read-only field. You can only specify the name when you create a new network listener.</p>
</dd>
<dt>Protocol</dt>
<dd>
<p>The protocol associated with the network listener. The Protocol field is a read-only field. You can create or specify a protocol only when you create a new network listener.</p>
<p>Select the Protocol used by the network listener to change its settings. For example, you can enable security.</p>
</dd>
<dt>Status</dt>
<dd>
<p>The status of the network listener. The listener can be enabled or disabled. This option is enabled by default. If the listener is disabled, any attempts to connect to the listener result in a socket exception (<code>java.net.ConnectException</code>).</p>
<p>In Payara Server versions prior to Application Server&nbsp;9.1, a listener whose enabled attribute was set to false returned a 404 response code for any requests sent to it. To achieve this behavior in the current Payara Server version, set the listener's status to enabled, and set every associated virtual server's state to OFF. A virtual server lists its associated listeners in its Network Listeners drop-down list.</p>
</dd>
<dt>Security</dt>
<dd>
<p>If this option is selected, security is enabled for the protocol used by the network listener. The Security field is a read-only field.</p>
<p>If you are configuring the <code>admin-listener</code> for the domain administration server (DAS), which uses the <code>server-config</code> configuration, this option is read-only. To enable security for this listener, you must enable secure administration. See <a href="../../../common/en/help/ref-securityadmin.html">Secure Administration</a>.</p>
</dd>
<dt>JK Listener</dt>
<dd>
<p>If this option is selected, the listener supports Apache's <code>mod-jk</code> protocol. The <code>mod-jk</code> protocol is a proprietary communication/network protocol between Apache's <code>httpd</code> (web server) and an Payara Server back-end instance. If the listener supports this protocol, <code>httpd</code> is supposed to handle all static content, whereas any requests for dynamic resources (i.e., Servlets and JSPs) are routed to the <code>mod-jk</code> enabled network listener of the Payara Server, using the <code>mod-jk</code> protocol. This option is disabled by default.</p>
</dd>
<dt>Port</dt>
<dd>
<p>The port number on which the listener will listen. Legal values are 1 through 65535. On a UNIX system, creating sockets that listen on ports 1 through 1024 requires superuser privileges.</p>
</dd>
<dt>Address</dt>
<dd>
<p>The IP address on which the network listener will listen. The address can be in dotted-pair or IPv6 notation. It can be <code>any</code> (for <code>INADDR_ANY</code>) to listen on all IP addresses. It can be a hostname.</p>
</dd>
<dt>Thread Pool</dt>
<dd>
<p>The thread pool associated with the network listener.</p>
</dd>
<dt>Transport</dt>
<dd>
<p>The type of transport for the network listener. By default, the only transport is <code>tcp</code>.</p>
</dd>
</dl>
<a id="sthref137" name="sthref137"></a>
<h5>Related Tasks</h5>
<ul>
<li>
<p><a href="task-networklistenernew.html">To Create a Network Listener</a></p>
</li>
<li>
<p><a href="task-networklisteneredit.html">To Edit a Network Listener</a></p>
</li>
<li>
<p><a href="task-networklistenerdelete.html">To Delete a Network Listener</a></p>
</li>
<li>
<p><a href="task-protocolnew.html">To Create a Protocol</a></p>
</li>
<li>
<p><a href="task-protocoledit.html">To Edit a Protocol</a></p>
</li>
<li>
<p><a href="task-protocolssledit.html">To Edit SSL Settings for a Protocol</a></p>
</li>
<li>
<p><a href="task-protocolhttpedit.html">To Edit HTTP Settings for a Protocol</a></p>
</li>
<li>
<p><a href="task-protocolfilecacheedit.html">To Edit File Cache Settings for a Protocol</a></p>
</li>
<li>
<p><a href="task-protocoldelete.html">To Delete a Protocol</a></p>
</li>
</ul>
<a id="sthref138" name="sthref138"></a>
<h5>Related asadmin Commands</h5>
<ul>
<li>
<p><a href="/resource/reference/en/help/reference/create-network-listener"><code>create-network-listener</code>(1)</a></p>
</li>
<li>
<p><a href="/resource/reference/en/help/reference/list-network-listeners"><code>list-network-listeners</code>(1)</a></p>
</li>
<li>
<p><a href="/resource/reference/en/help/reference/delete-network-listener"><code>delete-network-listener</code>(1)</a></p>
</li>
</ul>



<small>Copyright &#169; 2005, 2017, Oracle and/or its affiliates. All rights reserved. <a href="docinfo.html">Legal Notices</a></small>
<small>Portions Copyright &#169; [2017-2020] Payara Foundation and/or affiliates.</small>
